Add tags and categories to posts, and create a default tag page#83
Merged
Add tags and categories to posts, and create a default tag page#83
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Enables tag-based browsing for the MkDocs Material blog by turning on the tags plugin, adding a generated tags index page, and backfilling categories/tags frontmatter across existing posts to support filtering and organization.
Changes:
- Enabled the Material
tagsplugin and configuredtags_file: tags.md - Added
docs/tags.mdas the generated tags index page and linked it in site navigation - Added
categoriesandtagsfrontmatter to posts; updated README/AGENTS documentation accordingly
Reviewed changes
Copilot reviewed 82 out of 82 changed files in this pull request and generated 6 comments.
Show a summary per file
| File | Description |
|---|---|
| mkdocs.yml | Enables tags plugin and adds Tags page to nav |
| docs/tags.md | Adds tags index page with <!-- material/tags --> marker |
| docs/posts/2026/02/03/index.md | Adds categories/tags frontmatter |
| docs/posts/2026/01/28/index.md | Adds categories/tags frontmatter |
| docs/posts/2026/01/27/index.md | Adds categories/tags frontmatter |
| docs/posts/2026/01/20/index.md | Adds categories/tags frontmatter |
| docs/posts/2026/01/13/index.md | Adds categories/tags frontmatter |
| docs/posts/2026/01/12/index.md | Adds categories/tags frontmatter |
| docs/posts/2026/01/05/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/12/30/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/12/23/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/12/16/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/12/11/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/12/09/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/12/02/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/11/25/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/11/21/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/11/18/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/11/11/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/11/04/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/10/28/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/10/21/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/10/20/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/10/14/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/10/07/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/09/30/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/09/23/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/09/16/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/09/09/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/09/02/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/08/26/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/08/19/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/08/12/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/08/05/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/07/29/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/07/22/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/07/15/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/07/08/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/07/01/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/06/24/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/06/17/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/06/10/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/06/03/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/05/27/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/05/20/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/05/13/index.md | Normalizes authors formatting; adds categories/tags |
| docs/posts/2025/05/06/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/04/29/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/04/22/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/04/15/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/04/08/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/04/01/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/03/25/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/03/18/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/03/12/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/03/11/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/03/04/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/02/2025-02-25-habits/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/02/2025-02-18-editors/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/02/2025-02-11-accessing-data/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/02/2025-02-04-developer-education/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/01/2025-01-28-ensemble-hacking-on-picoctf/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2025/01/2025-01-21-office-environments/index.md | Adds categories/tags frontmatter |
| docs/posts/2025/01/2025-01-14-bold-predictions-for-2025/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2025/01/2025-01-07-archiving-2024-embracing-2025/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2024/12/2024-12-17-giving-generosity-and-kindness/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2024/12/2024-12-10-advent-of-code-mob-programming/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2024/12/2024-12-03-chat-cancelled/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2024/11/in-real-life-event-nov-26th-2024/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2024/11/2024-11-19-profit-increasing-income-and-reducing-expenses/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2024/11/2024-11-12-accounting-taxes-payroll-and-other-boring-but-necessary-tasks/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2024/11/2024-11-05-marketing-building-your-personal-or-company-brand/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2024/10/2024-10-29-unmasking-code-identifying-and-understanding-code-smells/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2024/10/2024-10-22-winterizing-your-codebase-preparing-for-stormy-weather/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2024/10/2024-10-15-giving-thanks-celebrating-successes-and-gratitude/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2024/10/2024-10-08-harvest-time-reaping-the-benefits-of-past-investments/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2024/10/2024-10-01-the-pumpkin-spice-latte-of-software-development-trends-and-fads/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2024/09/2024-09-24-live-from-bsides-maybe/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2024/09/2024-09-17-privacy-does-it-matter-anymore/index.md | Replaces quoted categories/tags; adds new categories/tags |
| docs/posts/2024/09/2024-09-10-picoctf-gym-pairing/index.md | Replaces quoted categories/tags; adds new categories/tags |
| README.md | Documents tag browsing and frontmatter fields |
| AGENTS.md | Documents tags plugin setup and frontmatter conventions |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Contributor
|
Looks good! Just wondering if some brief documentation about adding/removing tags and/or categories would be useful here. Is there particular formatting / casing? Even a link to the mkdocs page for them might be sufficient. |
Contributor
|
I like it. Btw, looking at the tag list showed that |
o-ashour
approved these changes
Feb 11, 2026
Contributor
o-ashour
left a comment
o-ashour
left a comment
There was a problem hiding this comment.
Looks reasonable to me.
normanlorrain
approved these changes
Feb 11, 2026
Member
Author
|
@normanlorrain I added the title to 2025/09/09. @o-ashour I've added some documentation to the README. Let me know if the documentation is not clear. |
Member
Author
|
Merging the PR. If anyone spots any issues, let me know or feel free to fix them yourself. |
Contributor
|
Nice job on the readme! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Enabled the tag plugin and used AI to add tags and categories to all posts. Also reordered the menu items.
@normanlorrain and @o-ashour let me know what you think. I haven't had a chance to check if the tags make sense. I'll likely check them later this week.